package net.luohuasheng.bee.proxy.mybatis.dao;


import net.luohuasheng.bee.proxy.mybatis.executor.criteria.Criteria;
import net.luohuasheng.bee.proxy.mybatis.executor.page.Page;
import net.luohuasheng.bee.proxy.mybatis.executor.page.Pageable;
import org.apache.ibatis.annotations.Param;

import java.io.Serializable;
import java.util.List;

/**
 * 读取公共方法
 *
 * @param <T> 泛型对象
 * @author panda
 */
public interface BasicReadDao<T> {


    /**
     * 根据主键获数据
     *
     * @param pks 主键
     * @return 所获取的对象
     */
    T getById(@Param("pks") Serializable... pks);

    /**
     * 根据查询对象获取实体对象
     *
     * @param criteria 查询对象
     * @return 所获取的对象
     */
    T getEntity(Criteria criteria);

    /**
     * 根据主键和字段名获数据
     *
     * @param fieldName 字段名
     * @param criteria  查询的对象
     * @param <V>       返回的对象泛型
     * @return 查询后的数据
     */
    <V> V getValue(@Param("fieldName") String fieldName, Criteria criteria);

    /**
     * 查询
     *
     * @param fieldName 字段名
     * @param criteria  查询的对象
     * @param <V>       返回的对象泛型
     * @return 查询后的数据
     */
    <V> List<V> getValues(@Param("fieldName") String fieldName, Criteria criteria);

    /**
     * 查询
     *
     * @param fieldName 字段名
     * @param pageable  分页参数
     * @param <V>       返回的对象泛型
     * @return 查询后的数据
     */
    <V> Page<V> getValuesForPage(@Param("fieldName") String fieldName, Pageable pageable);

    /**
     * 查询
     *
     * @param fieldName 字段名
     * @param pageable  分页参数
     * @param criteria  查询的对象
     * @param <V>       返回的对象泛型
     * @return 查询后的数据
     */
    <V> Page<V> getValuesForPage(@Param("fieldName") String fieldName, Criteria criteria, Pageable pageable);

    /**
     * 获取所有数据
     *
     * @return 返回的数据
     */
    List<T> getEntityList();

    /**
     * 根据查询对象获取数据
     *
     * @param criteria 查询对象
     * @return 返回的数据
     */
    List<T> getEntityList(Criteria criteria);


    /**
     * 获取所有数据
     *
     * @return 返回的数据
     */
    Long getEntityCount();

    /**
     * 根据查询对象获取数据
     *
     * @param criteria 查询对象
     * @return 返回的数据
     */
    Long getEntityCount(Criteria criteria);


    /**
     * 分页查询数据
     *
     * @param pageable 分页对象
     * @return 返回的数据
     */
    Page<T> getEntityListForPage(Pageable pageable);

    /**
     * 根据查询条件分页查询数据
     *
     * @param criteria 查询条件
     * @param pageable 分页条件
     * @return 返回的数据
     */
    Page<T> getEntityListForPage(Criteria criteria, Pageable pageable);


}
